3. Status Control Commands > 3.2 AT+CIND   Indicator control

3.2
AT+CIND   Indicator control
The AT+CIND command controls the presentation of Indicator Event Reports related to various functions such as battery charge level, signal quality, service availability, sound generation, indication of unread short mes­sages, full SMS storage, call in progress or roaming activities.
Use of AT+CIND has become outdated. Rather we recommend the more powerful AT^SIND command which is easier to use and provides additional indicators. All indicators provided by AT+CIND can be handled with AT^SIND as well.

AT+CIND supports two ways to get the values related to indicators:
•
One approach is to query the current status of each indicator by using the read command AT+CIND?. It returns the status no matter whether the indicator has been registered with the write command AT+CIND=[<mode>[,<mode>[,...]]].
•
The other way is an event-driven notification based on the "+CIEV" URCs. In this case, the ME will automat­ically send a message to the application, whenever the value of an indicator changes. The application should be designed to react adequately when receiving a URC.
The presentation of these URCs depends on two settings:
-
The indicators must be registered with the write command AT+CIND=[<mode>[,<mode>[,...]]]. When the ME is switched on all of them are in registered mode. Any indicator can be excluded if deregistered with <mode>=0. To register or deregister an indicator the AT+CIND write command requires to type the value <mode>=1 or 0 exactly at the position where the indicator is located in the list. This is not necessary with AT^SIND which allows to specify indicators by name. See examples below.
-
Syntax
Test Command  
Response(s)
+CIND: (<indDescr>, list of supported <indValue>s)[, (<indDescr>, list of supported <indValue>s)[, ...]]
Read Command  
Response(s)
Write Command  
Response(s)
Reference(s) 
PIN 
ASC0 
ASC1 
USB 
MUX1 
MUX2 
MUX3 
Charge 
Last 
GSM 07.07

Parameter Description
 
Integer type value, which shall be in range of corresponding <indDescr>
 
String values and their <indValue> ranges.
More indications are available via AT^SIND. Therefore use of AT^SIND for control of all indications is recom­mended.
The following indications are accessible via AT+CIND:
“battchg“
Battery charge level 0..4 or 5 if no measuring is performed, e.g because no bat­tery is connected. Also refer to AT^SBC.
“signal“
Signal quality (0..7)
The indicated value is the bit error rate of the signal received. Bit errors are esti­mated values. To check the bit error rate there must be a call in progress to obtain realistic values. If no call is set up, there is no BER to be determined. See also AT+CSQ.
“service“
Service availability (0-1)
0: Not registered to any network
1: Registered to home network or, if "roam"=1 then registered to another net­work
“sounder“
Sounder activity (0-1)
Reports every event that causes the ME to generate a tone.
Value 1 means for example:
Incoming call - ME is ringing. Note that the URC "+CIEV: sounder" will be out­put only if ringing tones are activated with AT^SRTC.
Waiting call - ME generates waiting call tone (if call waiting is enabled).
Outgoing call - ME generates Call Progress tone.
Outgoing call - ME generates BUSY tone.
The value changes to 0 when the tone stops.
“message“
Unread short message at memory location <mem1> (0-1); refer to AT+CPMS
“call“
Call in progress (0-1). Indicator value is "1" if at least one call is in state "active" or "held".
Depending on the parameter <succ> selected with AT^SCFG the indicator "call" will be issued
•
•
when any state transition (including transitions beginning or ending in state "unknown") occurs in the list of active calls or when a traffic channel is established, if <succ>="verbose".
Also refer to Section 7.1, Call Status Information.
“roam“
Roaming indicator (0-1)
0: Registered to home network or not registered
1: Registered to other network
“smsfull“
A short message memory storage in the MT has become full (1) or memory locations are available (0), i.e. range is (0-1)
“rssi“
Received signal (field) strength (0..5)
0: signal strength < -112 dBm
1-4: signal strength in 15 dB steps
5: signal strength > -51 dBm
Received signal (field) strength can also be obtained with AT+CSQ. However, the signal strength is scaled to value range 0..31 by this command.
 
<mode>(num)
0
Indicator is deregistered. The indicator will not be presented as "+CIEV" URC, but can be queried with AT+CIND?.
[1](&F)(P)
Indicator is registered, indicator event report allowed.


Notes
•
Due to its restrictive value range, indicator "call" does not clearly reflect specific call states (such as alerting, active, held etc.), but rather serves to trigger the application to retrieve the new call status from the list of cur­rent calls with the AT commands AT^SLCC, AT+CLCC or AT^SCNI.
•
If AT^SCFG setting <succ>="verbose", indicator "call" will be issued also when a traffic channel is estab­lished, or when a call enters states "terminating" or "dropped" (see Call Status Information).
In these cases, the relevant information about the cause of the display is available only from AT command AT^SLCC.

Examples

EXAMPLE 1
 
The battery is either full or no battery is connected to the ME. The bit error rate of the signal quality is not available (since there is no call in progress). The ME is registered to its home network.
A set of "+CIEV" URCs is received.
EXAMPLE 2


Deactivation of indicator "sounder" via AT+CIND
 
EXAMPLE 3


Deactivation of indicator "sounder" via AT^SIND